home *** CD-ROM | disk | FTP | other *** search
Text File | 1992-12-20 | 43.1 KB | 1,046 lines |
-
- '.
- APrf2 - Manuel d'utilisation
-
-
-
-
-
- AboutThisDoc
-
- Ce manuel décrit la version 2.10 de l'utilitaire APrf2. Ce programme
- est (c)1989-1990-1991-1992 par Denis GOUNELLE, toute utilisation commerciale
- ou vente sans autorisation écrite est strictement interdite. Vous pouvez
- copier et diffuser ce programme aux conditions suivantes :
-
- - l'ensemble des fichiers doit être fourni
- - aucun fichier ne doit avoir été modifié
- - vous ne devez pas demander plus de 40FF pour cela
-
- "PowerPacker 2.3b" est (c)1989 par PowerPeak et Nico FRANCOIS,
- "PowerPacker Pro 3.0b" est (c)1990 par PowerPeak et par UGA Software. La
- bibliothèque "powerpacker.library" est (c)1990 par Nico FRANCOIS. AREXX est
- (c)1987 par William Hawes. La bibliothèque "reqtools.library" est
- (c)1990-1991 par Nico FRANCOIS.
-
- Malgrès de nombreux tests, je ne peux garantir qu'APrf ne contient
- aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS RISQUES ET PERILS. Je ne
- pourrai en aucun cas être tenu responsable de tout dommage, direct ou
- indirect, résultant de l'utilisation d'APrf.
-
- Introduction
-
- APrf2 est une nouvelle version de APrf, capable d'utiliser les
- fonctions de la version 2.0 du système. Ce programme peut toujours être
- utilisé avec le système 1.3, bien que certaines des nouvelles possibilités
- ne soient pas disponibles dans ce cas.
- APrf est un utilitaire d'impression qui permet (entre autres)
- l'ajout d'une entête, d'un pied de page, de marges, la numérotation des
- lignes, l'impression sur plusieurs colonnes, etc... et utilise les valeurs
- fixées dans les Préférences. APrf dispose de plus d'un port compatible
- AREXX, d'une fenêtre d'application (ou "AppWindow", sous système 2.0
- uniquement) et peut charger des fichiers compactés par "PowerPacker 2.3b" ou
- par "PowerPacker Pro 3.0b".
- Vous pouvez me faire part de vos remarques ou critiques sur APrf, en
- écrivant à l'adresse suivante :
-
- M. GOUNELLE Denis
- Boite 71
- 6, rue des cailloux
- 92110 CLICHY - FRANCE
-
- Vous pouvez également m'adresser un message à l'adresse Internet
- "gounelle@alphanet.ch". Notez qu'il s'agit d'une boite à lettre mise à ma
- disposition par un ami, aussi veuillez n'envoyer que de courts messages. De
- plus, n'ayant pas accès directement à mes messages, n'espérez pas avoir une
- réponse avant une dizaine de jours.
- Merci à Serge HAMMOUCHE, Jean-Yves PROUX, Jean-Philippe RAPP, Jean
- ROUGELIN, Michel SCHINZ, et Pierre VITET, pour leurs tests et leurs idées.
- En France, la dernière version de ce programme est disponible auprès
- de Serge HAMMOUCHE, 3 rue Anatole France, 13220 Chateauneuf-les-Martigues.
- Pour recevoir le catalogue complet, il vous suffit d'envoyer deux timbres à
- cette adresse.
-
- Appel_depuis_le_CLI
-
- Il n'y a pas besoin d'utiliser une commande "RunBack" ou "ARun", car
- APrf se détache automatiquement de la fenêtre CLI. Vous pouvez appeler APrf
- avec une série d'options qui permettent de modifier les paramêtres par
- défaut. La syntaxe de la ligne de commande est :
-
- APrf [fichier][-c#][-d#][-e#][-f#,#][-g#][-n#][-p#][-t#][-vF]
- [-x#][-A][-Cseq][-D#][-E{G|C|D}fmt][-F{G|C|D}][-Ifont]
- [-N#][-Oopts][-P{p|e|f}][-Spages][-X]
-
- Si on précise l'argument <fichier>, le fichier correspondant sera
- considéré comme le fichier à imprimer. Voici la description des autres
- options :
-
- -c# (nombre de Colonnes)
- Imprime sur # colonnes.
- Valeur par défaut : # = 1.
- Valeur minimale : # = 1. Valeur maximale : # = 999.
-
- -d# (marge Droite)
- Ajoute une marge droite de # caractères. Notez que les
- marges fixées dans les Préférences sont prises en compte
- quoi qu'il arrive.
- Valeur par défaut : # = 0.
- Valeur minimale : # = 0. Valeur maximale : # = 999.
-
- -e# (Espacement)
- Sépare les colonnes par # espaces.
- Valeur par défaut : # = 1.
- Valeur minimale : # = 1. Valeur maximale : # = 999.
-
- -f#,# (Format de page)
- Sélectionne le format de la page et les pages où faire la
- présentation. Le premier # peut prendre les valeurs
- suivantes :
-
- 0 pas de format particulier
- 1 ajoute une entête
- 2 ajoute un pied de page
- 3 ajoute une entête et un pied de page
-
- Valeur par défaut : # = 1.
-
- Le second # peut prendre les valeurs suivantes :
-
- 0 sur toutes les pages
- 1 sur toutes les pages sauf la première
- 2 sur les pages paires
- 3 sur les pages impaires
-
- Valeur par défaut : # = 0
-
- Il est possible de n'indiquer qu'un seul paramètre : les
- formes "-f1,2", "-f1" et "-f,2" sont acceptées. Pour plus de
- détails voir §2.6
-
- -g# (marge Gauche)
- Ajoute une marge gauche de # caractères. Notez que les
- marges fixées dans les Préférences sont prises en compte
- quoi qu'il arrive.
- Valeur par défaut : # = 0.
- Valeur minimale : # = 0. Valeur maximale : # = 999.
-
- -n# (Numérotation des lignes)
- Numérote les lignes (numéros de # chiffres).
- Valeur par défaut : # = 0 (pas de numéros de ligne).
- Valeur minimale : # = 0. Valeur maximale : # = 10.
-
- -p# (longueur des Pages)
- Imprime par pages de # lignes.
- Valeur par défaut : "Paper Length" des Préférences.
- Valeur minimale : # = 5. Valeur maximale : # = 999.
-
- -t# (Tabulation)
- Règle les positions des tabulations sur les colonnes #+1,
- 2#+1, 3#+1, etc...
- Valeur par défaut : # = 8.
- Valeur minimale : # = 1. Valeur maximale : # = 999.
-
- -vF (Vers)
- L'impression est redirigée vers le fichier F.
-
- -x# (eXemplaires)
- Imprime # exemplaires du fichier.
- Valeur par défaut : # = 1.
- Valeur minimale : # = 1. Valeur maximale : # = 999.
-
- -A (mode AREXX)
- Place APrf en mode AREXX (voir §3.3)
-
- -Cseq (séquence de Contrôle)
- Sélectionne la séquence de contrôle "seq" (voir §3.5).
-
- -D# (format de la Date)
- Indique le format de la date dans l'entête. # peut prendre
- les valeurs :
-
- 0 format AmigaDOS (jj-mmm-aa)
- 1 format international (aa-mm-jj)
- 2 format américain (mm-jj-aa)
- 3 format européen (jj-mm-aa)
-
- Valeur par défaut : # = 0.
- Pour plus de détails voir §2.6.
-
- -E{G|C|D}fmt (format de l'Entête)
- Indique le format de l'entête.
- Pour plus de détails voir §2.6.
-
- -F{G|C|D}fmt (format du pied de page)
- Indique le format du pied de page.
- Pour plus de détails voir §2.6.
-
- -Ifont (police Interne)
- Sélectionne la police interne indiquée.
- Pour plus de détails voir §3.5.
-
- -N# (Numéro de la première page)
- La numérotation des pages commence au nombre #.
- Valeur par défaut : # = 1.
- Valeur minimale : # = 1. Valeur maximale : # = 899.
-
- -Oopts (Options)
- Permet de modifier certaines options. "opts" est une
- combinaison quelconque des caractères :
-
- c qualité courrier
- l qualité listing
- 8 interligne 8LPI
- 6 interligne 6LPI
- C alimentation papier continu
- F alimentation feuilles à feuilles
- t tronque les lignes trop longues
- f filtre les caractères de contrôle
- a filtre les séquences d'échappement
- k tampon de sortie d'un kilo-octets
- n n'envoit pas de sauts de page
- u souligne l'entête
-
- Voir la description du menu "Options" au §2.5 pour plus de
- détails.
-
- -P{p|e|f} (Pas d'impression)
- Permet de sélectionner le pas d'impression :
-
- -Pp pica
- -Pe elite
- -Pf fine
-
- Valeur par défaut : "Pitch" des Préférences.
-
- -Spages (Sélection)
- Permet de sélectionner les pages à imprimer. La sélection
- peut prendre les formes suivantes :
-
- x page x uniquement
- i pages impaires
- p pages paires
- x-y pages x à y
- x,y,z,... pages x,y,z,...
-
- Vous pouvez également utiliser une combinaisons des quatre
- dernières formes, comme par exemple "-S1,3,5-8" ou
- "-Sp,1,3".
-
- ATTENTION : les numéros de page indiqués dans la sélection
- doivent tenir compte du numéro de la première page (voir
- option -N)
-
- -X (eXpress)
- Lance APrf en mode eXpress (voir §3.2).
-
- En cas d'erreur dans la ligne de commande, une fenêtre apparait sur
- l'écran Workbench, portant le message "Arguments incorrects". Cliquez sur le
- gadget "OK" pour la faire disparaitre, et relancez APrf après correction de
- la ligne de commande.
- Notez que le menu "Outils" possède une commande qui permet de savoir
- quelles options de la ligne de commande correspondent aux options courantes
- (voir §2.5 pour plus de détails).
-
- Appel_depuis_le_Workbench
-
- Il y a trois façon d'appeler APrf depuis le Workbench quand on veut
- lui indiquer le ou les fichiers à imprimer :
-
- - en double-cliquant sur une icône de type "Project" qui a APrf
- comme outil par défaut ("Default tool")
- - en cliquant sur une ou plusieurs icônes de fichiers puis en
- double-cliquant sur l'icône d'APrf tout en gardant la touche
- SHIFT enfoncée.
- - en cliquant sur l'icône d'APrf (et éventuellement sur des icônes
- de fichiers) puis en double-cliquant sur une icône de fichier
- tout en gardant la touche SHIFT enfoncée.
-
- Dans tous les cas, le ou les fichiers sélectionnés sont transmis à
- APrf, qui affiche le nom du premier fichier dans le gadget "Fichier à
- imprimer" (voir §2.4). La commande "Fichier suivant" du menu "Projet" permet
- de passer au fichier suivant (voir §2.5), et la commande "Options défaut" du
- menu "Outils" permet de revenir au premier fichier de la liste (voir §2.5).
-
- Comme pour l'appel depuis le CLI, il est possible d'appeler APrf
- avec des options. Pour ce faire, cliquez sur l'icône du fichier à imprimer,
- appelez le menu "Icons" du Workbench et choisissez l'item "Information".
- Ensuite, cliquez sur le gadget "New" de la zone "TOOL TYPES" et entrez les
- options en respectant la syntaxe suivante :
-
- APRF=[-c#][-d#][-e#][-f#,#][-g#][-n#][-p#][-t#][-vF][-x#]
- [-Cseq][-D#][-E{G|C|D}fmt][-F{G|C|D}][-Ifont][-N#]
- [-Oopts][-P{p|e|f}][-Spages]
-
- Ces options sont décrites au paragraphe précédent (§2.1). Si vous
- appelez APrf depuis le Workbench sans arguments (juste en double-cliquant
- sur l'icône d'APrf) les options seront cherchées dans le champ "TOOL TYPES"
- de l'icône d'APrf.
- Notez que les options -A (mode AREXX) et -X (mode eXpress) ne
- peuvent être utilisées en cas d'appel depuis le Workbench.
-
- Démarrage
-
- APrf utilise la version 2.0c de la bibliothèque "reqtools.library".
- Vous devez donc copier cette bibliothèque dans le répertoire "LIBS:", si ce
- n'est déjà fait.
-
- Si tout se passe bien, un écran s'ouvre, sur lequel apparaissent une
- vingtaine de gadgets. Un port AREXX est également ouvert (voir §3.3). Sous
- système 2.0, APrf ouvre systématiquement une "AppWindow" (fenêtre
- d'application, voir §3.4). Sinon, une fenêtre apparait sur l'écran
- Workbench, indiquant le problème rencontré. Cliquez sur le gadget "OK" pour
- la faire disparaitre, APrf s'arrête et retourne la valeur 10 (ERROR, voir
- commande IF de l'AmigaDOS).
-
- Il se peut que APrf rende la main sans dire pourquoi, c'est-à-dire
- sans afficher aucun message, mais en retournant cependant la valeur 10. Ceci
- ne peut se produire que dans trois cas :
-
- - APrf n'a pu ouvrir la bibliothèque "reqtools.library"
- - APrf n'a pu ouvrir la fenêtre pour afficher le message d'erreur
- - APrf n'a pu ouvrir l'écran Workbench
-
- Je suppose maintenant que le programme a démarré correctement. Les
- deux chapitres qui suivent vont vous expliquer comment utiliser les gadgets
- et les menus d'APrf. Si vous utilisez APrf pour la première fois, je vous
- conseille de lancer le programme afin de pouvoir mieux suivre les
- explications.
-
- Les_gadgets
-
- Ce paragraphe décrit les gadgets affichés sur l'écran, de haut en
- bas et de gauche à droite.
-
- Fichier à imprimer
-
- Ce gadget indique le nom du fichier à imprimer.
- Pour modifier sa valeur il suffit de cliquer dessus. Une boite
- de requête apparait, vous permettant de choisir le fichier à
- imprimer. Si vous cliquez sur le gadget "CANCEL", ou sur le
- gadget "OK" sans avoir choisi de fichier, l'ancien nom de
- fichier sera conservé.
- Le caractère "*" apparait à droite du nom de fichier quand le
- fichier est chargé en mémoire (voir §4.1).
-
- Fichier de sortie
-
- Ce gadget indique où sera envoyée l'impression. Par défaut il
- indique "PRT:", mais cette valeur peut être changée à l'appel
- grâce à l'option -v (voir §2.1).
- Pour modifier la valeur de ce gadget, il suffit de cliquer
- dessus. Une boite de requête apparait, vous permettant de
- choisir le fichier de sortie. Si vous cliquez sur "CANCEL", le
- fichier de sortie devient "PRT:".
-
- Pages sélectionnées
-
- Ce gadget indique quelles pages seront imprimées. Par défaut il
- indique "*", ce qui signifie "toutes les pages", mais cette
- valeur peut être changée à l'appel grâce à l'option -S (voir
- §2.1).
- Pour modifier la valeur de la sélection, reportez-vous au §2.8.
-
- Les neufs gadgets suivants permettent de spécifier respectivement :
- la taille de la marge gauche, la taille de la marge droite, la longueur des
- tabulations, le nombre de lignes par page, le numéro de la première page, la
- taille des numéros de lignes, le nombre de colonnes, l'espacement des
- colonnes, et le nombre d'exemplaires à imprimer.
- Chacun de ces gadgets indique la valeur actuelle du paramêtre
- correspondant, suivit par une flèche vers le haut et une flèche vers le bas.
- Vous pouvez cliquer sur la valeur, et la modifier au clavier (appuyez sur
- Amiga-X pour effacer la valeur précédente, n'oubliez pas d'appuyer sur
- <RETURN> pour valider la nouvelle valeur). Vous pouvez également cliquez sur
- la flèche vers le haut pour augmenter la valeur, ou sur la flèche vers le
- bas pour la réduire. Si la valeur ne change pas, c'est que vous avez atteind
- la limite inférieure ou supérieure admise pour ce paramêtre. La valeur
- augmente ou diminue automatiquement tant que vous appuyez sur le bouton
- gauche de la souris.
-
- Marge gauche : (voir §2.1, option -g)
- Valeur par défaut : 0
- Valeur minimale : 0
- Valeur maximale : 999
-
- Marge droite : (voir §2.1, option -d)
- Valeur par défaut : 0
- Valeur minimale : 0
- Valeur maximale : 999
-
- Tabulation : (voir §2.1, option -t)
- Valeur par défaut : 8
- Valeur minimale : 1
- Valeur maximale : 999
-
- Lignes par page : (voir §2.1, option -p)
- Valeur par défaut : "Paper length" des Préférences
- Valeur minimale : 5
- Valeur maximale : 999
-
- No première page : (voir §2.1, option -N)
- Valeur par défaut : 1
- Valeur minimale : 1
- Valeur maximale : 899
-
- La sélection des pages est effacée à chaque modification
- du numéro de la première page.
-
- No de lignes : (voir §2.1, option -n)
- Valeur par défaut : 0 (pas de numéros de ligne)
- Valeur minimale : 0 (pas de numéros de ligne)
- Valeur maximale : 10
-
- Colonnes : (voir §2.1, option -c)
- Valeur par défaut : 1
- Valeur minimale : 1
- Valeur maximale : 999
-
- Espacement : (voir §2.1, option -e)
- Valeur par défaut : 1
- Valeur minimale : 1
- Valeur maximale : 999
-
- Exemplaires : (voir §2.1, option -x)
- Valeur par défaut : 1
- Valeur minimale : 1
- Valeur maximale : 999
-
- Les cinq gadgets suivants proposent différentes valeurs, que vous
- pouvez faire défiler en cliquant sur le gadget en forme de flèche affiché
- juste à droite de la valeur. Si vous appuyez sur une des touches SHIFT en
- même temps, les valeurs défileront en sens inverse.
-
- Caractères
-
- Ce gadget indique le pas d'impression. Par défaut, le pas
- est celui indiqué dans le champ "Pitch" des Préférences,
- mais cela peut être changé à l'appel grâce à l'option -P
- (voir §2.1).
-
- Police
-
- Ce gadget indique la police interne à utiliser. Normalement
- il s'agit de la police par défaut, mais cela peut être
- changé à l'appel grâce à l'option -I (voir §2.1). Pour plus
- de détails, voir §3.5.
-
- Format Date
-
- Ce gagdet indique dans quel format sera la date. Par défaut
- le format est le format AmigaDOS, mais ceci peut être changé
- à l'appel grâce à l'option -D (voir §2.1). Pour plus de
- détails, voir §2.6.
-
- Format Page
-
- Ce gadget indique le format de page courant. Par défaut le
- format est "entête", mais ceci peut être changé à l'appel
- grâce à l'option -f (voir §2.1). Pour plus de détails, voir
- §2.6.
-
- sur
-
- Ce gadget indique sur quelles pages seront ajoutés l'entête
- et/ou le pied de page. Par défaut, ce sera sur toutes les
- pages, mais ceci peut être changé à l'appel grâce à l'option
- -f (voir §2.1). Pour plus de détails, voir §2.6.
-
- Les gadgets suivants vous permettent de personnaliser l'entête et le
- pied de page.
-
- Entête
-
- Ce gadget indique le format des trois parties de l'entête :
- la partie gauche, la partie centrale, et la partie droite.
- La valeur par défaut de chaque partie peut être changée à
- l'appel grâce à l'option -E (voir §2.1).
- Pour modifier la valeur d'une des parties, il vous suffit de
- cliquer dessus : une fenêtre avec un gadget de chaine
- apparait alors. Appuyez sur Amiga-X pour effacer la valeur,
- sur RETURN pour valider, ou cliquez sur le bouton de
- fermeture pour annuler l'opération.
- Pour plus de détails, voir §2.6.
-
- Pied de page
-
- Fonctionne de la même façon que pour l'entête. La valeur par
- défaut peut être changée à l'appel grâce à l'option -F (voir
- §2.1). Pour plus de détails, voir §2.6.
-
- Les deux gadgets en forme de losange, en bas de l'écran, permettent
- de lancer l'impression (celui de gauche) et de lancer la pré-visualisation
- (celui de droite) sans avoir à passer par les menus.
- Vous pouvez également cliquer sur le gadget de fermeture de la
- fenêtre principale (en haut à gauche) pour quitter le programme, ou sur le
- gadget "zoom" (en haut à droite, sous système 2.0 uniquement) pour iconifier
- APrf.
-
- Les_menus
-
- APrf possède trois menus : le menu "Projet", le menu "Outils" et le
- menu "Options". Chaque commande peut être sélectionnée à l'aide de la souris
- ou de raccourcis clavier, par contre les items du menu "Options" ne peuvent
- être modifiés qu'à la souris. Les rubriques du menu "Projet" sont les
- suivantes :
-
- Fichier suivant (Amiga-F)
-
- Si vous avez appelé APrf depuis le Workbench en
- sélectionnant plusieurs fichiers, cette commande permet de
- passer au fichier suivant dans la liste des fichiers
- sélectionnés. Le gadget "Fichier à imprimer" est mis à jour
- (voir §2.4) et l'ancien fichier est vidé de la mémoire (s'il
- était chargé, voir §4.1).
-
- Imprime (Amiga-P)
-
- Lance l'impression.
-
- Palette
-
- Vous permet de modifier les couleurs de l'écran de APrf.
- Pour sauvegarder la nouvelle palette immédiatement, appelez
- la commande "Sauve config" et entrez "palette" comme nom de
- configuration. Sinon, lorsque vous voudrez quitter le
- programme, APrf vous demandera si vous voulez sauver la
- nouvelle palette.
-
- A Propos... (Amiga-?)
-
- Affiche quelques informations sur APrf. Pour faire
- disparaitre la fenêtre, cliquez à l'intérieur ou appuyez sur
- une touche.
-
- Iconifie (Amiga-I)
-
- Iconifie APrf. L'écran d'APrf est fermé et, sous système 1.3
- une petite fenêtre dont le titre est "APrf2 v2.10" vient se
- placer dans le coin supérieur gauche de l'écran Workbench.
- Sous système 2.0, la fenêtre d'application reste ouverte.
- Notez que le port AREXX est toujours actif pendant que APrf
- est iconifié.
- Pour réveiller APrf, rendez cette fenêtre active puis
- cliquez sur le bouton droit de la souris. Vous pouvez
- quitter APrf lorsqu'il est iconifié sans avoir à le
- réveiller, en cliquant sur le gadget de fermeture de la
- fenêtre.
-
- Quitte (Amiga-Q ou ESCAPE)
-
- Termine l'exécution d'APrf. Une boite de requête apparaitra
- pour vous demander confirmation.
-
- Voici la description des commandes du menu "Outils" :
-
- Options défaut (Amiga-D)
-
- Permet de recharger les options par défaut (dans l'ordre :
- valeurs des Préférences, puis options de la ligne de
- commande). Si vous avez appelé APrf depuis le Workbench en
- sélectionnant plusieurs fichiers, le premier fichier
- sélectionné devient le fichier à imprimer.
- Cette commande peut être utile (entre autres) si vous avez
- changé les Préférences, car cela permet à APrf de prendre en
- compte ces modifications sans que vous ayez à quitter le
- programme.
-
- Charge fichier (Amiga-C)
-
- Permet de charger immédiatement le fichier à imprimer en
- mémoire. Si ce fichier était déjà en mémoire, il est
- rechargé quand même (voir §4.1).
-
- Libère fichier (Amiga-L)
-
- Permet de libérer la mémoire occupée par le fichier à
- imprimer (voir §4.1)
-
- Commande "Pré-visualise" (Amiga-V) :
-
- Permet de visualiser la mise en page du fichier à imprimer.
- (voir §2.7).
-
- Ligne de cmd (Amiga-K)
-
- Affiche la liste des options à donner à l'appel pour que les
- paramêtres d'impressions aient leur valeur actuelle. Pour
- faire disparaitre la fenêtre, cliquez à l'intérieur ou
- appuyez sur une touche.
-
- Sauve config (Amiga-S)
-
- Sauve les options courantes (sauf le nom du fichier à
- imprimer) en créant une nouvelle ligne dans le fichier
- "S:APrf.Init". Une fenêtre apparait, et vous devez entrer le
- nom de la nouvelle configuration. Cliquez sur le gadget de
- fermeture de la fenêtre pour annuler l'opération. Notez que
- le nouveau fichier de configuration n'est pas rechargé. Voir
- §3.5 pour d'autres détails.
-
- Doc info (Amiga-X)
-
- Affiche le nombre de pages, de lignes et de caractères que
- produira l'impression du fichier courant. Ce décompte tient
- compte de toutes les options de mise en page, mais notez que
- le nombre de caractères est approximatif. Pour faire
- disparaitre la fenêtre, cliquez sur le gadget "OK".
-
- Voici la description des items du menu "Options" :
-
- Courrier
-
- Permet de sélectionner la qualité d'impression : "courrier"
- ou "listing". Par défaut la qualité est celle indiquée par
- le champ "Print Quality" des Preferences, mais cela peut
- être changé à l'appel par l'option -O (voir §2.1).
-
- 8 LPI
-
- Permet de régler l'interligne : "8 LPI" ou "6 LPI". Par
- défaut l'interligne est celui indiqué par le champ "Spacing"
- des Préférences, mais cela peut être changé à l'appel par
- l'option -O (voir §2.1).
-
- Continu
-
- Permet d'indiquer comment est alimentée votre imprimante :
- par du papier en continu, ou feuille à feuille. Par défaut,
- l'alimentation est celle indiquée par le champ "Paper type"
- des Préférences, mais cela peut être changé à l'appel grâce
- à l'option -O (voir §2.1).
-
- Tronque
-
- Si cette option est active, les lignes trop longues seront
- tronquées au lieu d'être imprimées sur plusieurs lignes.
- Normalement cette option n'est pas active, mais cela peut
- être changé à l'appel grâce à l'option -O (voir §2.1).
-
- Filtre CTRL
-
- Si cette option est active, les caractères de contrôle (code
- ASCII inférieur à 32 ou supérieur à 126) trouvés dans le
- fichier à imprimer ne seront pas envoyés à l'imprimante.
- Normalement cette option n'est pas active, mais cela peut
- être changé à l'appel grâce à l'option -O (voir §2.1).
-
- Filtre ANSI
-
- Si cette option est active, les séquence d'échappement ANSI
- (définies au §5) trouvées dans le fichier à imprimer ne
- seront pas envoyés à l'imprimante. Normalement cette option
- n'est pas active, mais cela peut être changé à l'appel grâce
- à l'option -O (voir §2.1).
-
- Tampon 1Ko
-
- Si cette option est active, le tampon de sortie aura une
- taille d'un kilo-octet (et non d'une page). Normalement
- cette option n'est pas active, mais cela peut être changé à
- l'appel grâce à l'option -O (voir §2.1). Voir §4.2 pour plus
- de détails.
-
- Envoie FF
-
- Si cette option est active, un caractère "saut de page"
- (Form Feed) est envoyé à la fin de chaque page. Normalement
- cette option est active, mais cela peut être changé à
- l'appel grâce à l'option -O (voir §2.1).
-
- Soul.entête
-
- Si cette option est active, l'entête sera souligné lors de
- l'impression. Normalement cette option n'est pas active,
- mais cela peut être changé à l'appel grâce à l'option -O
- (voir §2.1).
-
- Entête_et_pied_de_page
-
- APrf vous permet d'ajouter une entête, un pied de page, ou les deux,
- sur vos documents. Le choix se fait soit à l'appel (option -f, voir §2.1)
- soit avec le gadget "Format Page" (voir §2.4). L'entête et le pied de page
- utilisent chacun deux lignes sur la page.
-
- Lorsque vous demandez une entête (et/ou un pied de page), APrf
- utilise la valeur des gadgets "Entête" (et/ou "Pied de page") pour composer
- cette entête (et/ou ce pied de page). Le gadget à gauche indique ce qui sera
- écrit à gauche, le gadget central ce qui sera écrit au milieu, et le gadget
- à droite ce qui sera écrit à droite. Les spécifications de format peuvent
- utiliser les séquences suivantes :
-
- %a nom du jour de la semaine (e.g. "Lundi")
- %b nom du mois (complet, e.g. "septembre")
- %B nom du mois (abbrégé, e.g. "Sep")
- %d jour du mois (01 à 31)
- %D date telle qu'indiquée par le gadget "Format Date"
- %f nom de base du fichier (e.g. "toto")
- %F nom complet du fichier (e.g. "RAM:titi/toto")
- %h heure (00 à 11)
- %H heure (00 à 23)
- %m mois (01 à 12)
- %M minutes (00 à 59)
- %n numéro de page
- %p période de la journée (AM ou PM)
- %s taille du fichier en octets
- %S secondes (00 à 59)
- %v version du programme (e.g. "APrf v4.20")
- %w jour de la semaine (0 à 6)
- %x numéro d'exemplaire
- %y année (00 à 99)
-
- La valeur par défaut de l'entête est "%f" pour la partie gauche,
- "Page %n" pour la partie centrale, et "%D" pour la partie droite. La valeur
- par défaut du pied de page est "Page %n" pour la partie centrale, et rien
- pour les autres parties.
- Vous avez la possibilité d'indiquer un format différent pour
- l'entête (et/ou le pied de page), soit en cliquant sur le gadget
- correspondant à la partie que vous voulez modifier, soit à l'appel avec
- l'option -E (et/ou l'option -F) : "-EGformat" modifie la valeur par défaut
- de la partie gauche, "-ECformat" celle de la partie centrale, et "-EDformat"
- celle de la partie droite.
- Vous pouvez également préciser sur quelles pages doivent apparaitre
- l'entête (et/ou le pied de page), soit avec le gadget "sur" (voir §2.4),
- soit à l'appel à l'aide de l'option -f (voir §2.1).
-
- Pré_visualisation
-
- Cette fonction vous permet de voir l'aspect final du texte en
- fonction des options de mise en page. Pour l'utiliser, réglez tous les
- paramêtres d'impression, puis choisissez la commande "Pré-visualise" du menu
- "Outils". Une fenêtre apparait au milieu de l'écran, et vous montre le
- résultat de la mise en page en commençant par la première page sélectionnée
- (la taille de la fenêtre est fonction de la taille de la page).
- Pour passer à la page suivante, cliquez à l'intérieur de la fenêtre,
- ou appuyez sur la touche RETURN. A tout moment vous pouvez arrêter
- l'opération en cliquant sur le gadget de fermeture ou en appuyant sur la
- touche ESCAPE.
- Notez cependant que si la longueur des pages est très grande (plus
- de 120 lignes en mode PAL, ou plus de 90 lignes en mode NTSC), APrf ne
- pourra pas ouvrir la fenêtre de pré-visualisation.
-
- Modification_de_la_sélection
-
- Pour modifier la sélection des pages à imprimer, cliquez sur le
- gadget "Pages sélectionnées". Une fenêtre apparaitra au milieu de l'écran.
- La partie supérieure de cette fenêtre est une grille de 100 cases, dont les
- numéros correspondent aux numéros de pages. Les numéros sont écrits en noir
- sur blanc si la page correspondante est sélectionnée, en noir sur bleu dans
- le cas contraire. Si vous cliquez sur un numéro, vous inverserez la
- sélection de la page correspondante. Vous avez également à votre disposition
- les gadgets suivants :
-
- TOUT sélectionne toutes les pages
- INVERSER inverse la sélection
- RIEN aucune page n'est sélectionnée
- VALIDER validation de la nouvelle sélection (ou RETURN)
- REPRENDRE reprise de la sélection précédente
- ANNULER annulation de la nouvelle sélection (ou ESCAPE)
-
- Vous pouvez également utiliser le gadget de chaine pour spécifier de
- nouvelles pages à sélectionner (en plus de celles qui le sont déjà). Les
- valeurs admises dans ce gadget sont :
-
- * toutes les pages
- x page x uniquement
- p pages paires
- i pages impaires
- x-y pages x à y
- x,y,z,... pages x,y,z,...
-
- Vous pouvez utiliser une combinaisons des deux dernières formes,
- comme par exemple "1,3,5-8" ou "p,1,3".
- N'oubliez pas que la sélection dépend du numéro de la première page.
- Notez enfin que vous ne pourrez valider si aucune page n'est sélectionnée.
-
- La_bibliothèque_powerpacker.library
-
- APrf utilise la bibliothèque "powerpacker.library", si elle est
- présente dans le répertoire LIBS: de votre disquette Workbench ou de votre
- disque dur. Ceci vous permet de demander l'impression d'un fichier compacté
- par les logiciels "PowerPacker 2.3b" ou "PowerPacker Pro 3.0b" : le fichier
- sera automatiquement décompacté lors de son chargement. Si le fichier avait
- été crypté, APrf vous demandera le mot de passe nécessaire à son décodage.
-
- Le_mode_eXpress
-
- Il peut arriver que vous ayez envie d'imprimer un fichier
- rapidement, sans faire appel à l'interface Intuition d'APrf (si vos
- Préférences sont réglées correctement c'est sans doute souvent le cas). Dans
- ce but, l'option -X a été ajouté à APrf : en présence de cette option, une
- fois la ligne de commande analysée, l'impression démarre directement. APrf
- n'ouvre pas d'écran, et s'arrête une fois l'impression achevée. Les messages
- d'erreur éventuels sont affichés sur l'écran Workbench, dans une fenêtre
- spéciale.
-
- Le_mode_AREXX
-
- Lors du démarrage, APrf ouvre systématiquement un port compatible
- AREXX nommé "APrf_rexx" et attend des messages sur ce port. Les messages
- peuvent être :
-
- quit APrf ferme le port AREXX et termine
- wakeup APrf ferme le port AREXX et lance l'interface
- Intuition
- reset APrf recharge les Préférences et revient aux options
- par défaut
- load APrf charge en mémoire le fichier à imprimer. Si
- vous envoyez un message "load" sans avoir auparavant
- indiqué le nom du fichier à imprimer, la commande
- restera sans effet.
- print APrf lance l'impression
-
- Tout autre message est considéré comme des arguments et analysé de
- la même manière (voir §2.1 pour la syntaxe). En cas d'erreur APrf affiche un
- message sur l'écran Workbench, dans une fenêtre spéciale, et termine.
- Voici un exemple de programme AREXX, qui lance l'impression du
- fichier "S:Startup-Sequence" avec une marge gauche de 10 caractères, puis
- termine APrf :
-
- /* Imprime S:Startup-Sequence */
- ADDRESS "APrf_rexx"
- "S:Startup-Sequence -g10"
- "print"
- "quit"
-
- Notez les guillemets autour des commandes !
- Si vous indiquez l'option "-A" lors de l'appel d'APrf, celui-ci
- passe en mode AREXX : seule la fenêtre d'application (sous système 2.0) ou
- la fenêtre d'iconification (sous système 1.3) est ouverte et le programme se
- met automatiquement en mode iconifié (voir §2.5). Depuis l'interface
- Intuition, vous pouvez placer APrf en mode AREXX simplement en iconifiant le
- programme (commande "Iconifie" du menu "Projet" voir §2.5).
-
- La_fenêtre_d'application
-
- Sous système 2.0, APrf ouvre automatiquement une fenêtre
- d'application (ou "AppWindow") sur l'écran Workbench. Vous avez alors les
- possibilités suivantes :
-
- - si vous sélectionnez une ou plusieurs icônes, et que vous les
- faites glisser sur la fenêtre d'application, APrf fera passer
- son écran au premier plan (après l'avoir éventuellement ouvert),
- et vous pourrez alors imprimer le ou les fichiers comme si vous
- aviez appelé APrf depuis le Workbench.
- - si vous cliquez sur le gadget de fermeture de la fenêtre
- d'application, le programme s'arrêtera (sans confirmation en
- mode AREXX)
- - si vous activez la fenêtre d'application et cliquez sur le
- bouton droit de la souris, APrf ouvrira son écran et l'interface
- normale sera alors utilisable (équivalent à la commande "wakeup"
- depuis AREXX)
- - vous pouvez sauvegarder la taille et la position de la fenêtre
- d'application, en indiquant "appwin" comme nom de configuration
- (voir commande "Sauveg config" au §2.5)
-
- Notez que la fenêtre d'application remplace la fenêtre
- d'iconification.
-
- Le_fichier_APrf.Init
-
- Lors du démarrage, APrf essaye d'accéder au fichier "S:APrf.Init".
- Ce fichier vous permet de définir des configurations type et/ou des polices.
- Dans le premier cas, les lignes du fichier doivent avoir le format suivant :
-
- nom:options:séquence
-
- où "nom" et "options" sont des suites de caractères quelconques (il est
- conseillé de ne pas dépasser 8 caractères pour "nom"), et "séquence" est une
- suite de code décimaux, séparés par des espaces. Les parties "options" et
- "séquence" peuvent être vides. Seules les 8 premières configurations type
- sont prises en compte. Voici quelques exemples de lignes :
-
- mon8lpi:-p90 -O8:
- landscap:-p80:27 48 108 72
-
- Chaque nom indiqué apparaitra dans un nouveau menu : le menu "Contrôle". Si
- vous sélectionnez un nom dans ce menu, la chaine "options" sera
- immédiatement analysée comme une ligne de commande CLI. De plus, lors de
- l'impression, les caractères dont le code ASCII est indiqué dans la séquence
- correspondante seront envoyées à l'imprimante (après les séquences normales
- d'initialisation, mais avant le texte lui-même). Vous pouvez bien entendu
- sélectionner plusieurs noms en même temps.
- Lors d'un appel depuis le CLI ou depuis le Workbench, l'option -C
- (voir §3.1) permet de sélectionner une séquence dès le démarrage. La chaine
- "option" sera analysée après les options d'appel. Si la séquence spécifiée
- par l'option -C n'existe pas, cette option sera ignorée.
-
- Le fichier "S:APrf.Init" vous permet également d'utiliser, depuis
- APrf, les polices internes de votre imprimante. Pour cela, il vous suffit de
- rajouter une ligne de la forme :
-
- fontdef:nom:séquence
-
- où "nom" est le nom de la police, et "séquence" la suite de codes faisant
- passer votre imprimante dans la police indiquée. Voici un exemple :
-
- fontdef:Prestige:27 107 2 27 120 49
-
- Le nombre de polices n'est pas limité. La sélection de la police peut se
- faire soit à l'appel, à l'aide de l'option -I (voir §2.1), soit à l'aide du
- gadget "Police" (voir §2.4). Il est conseillé de placer les définitions de
- police en début de fichier, avant la définition des configurations type.
-
- Vous pouvez également indiquer les couleurs à utiliser pour l'écran
- de APrf, avec une ligne de la forme :
-
- palette: c1 c2 c3 c4
-
- où "c1", "c2", "c3" et "c4" sont les spécifications RVB de chaque couleur.
- Vous pouvez indiquer ces valeurs en décimal ou en hexadécimal (dans ce cas,
- ajoutez "0x" devant la valeur, par exemple "0x0F00"). Si vous indiquez
- plusieurs palettes, seule la dernière sera prise en compte.
-
- Enfin, il est possible de préciser la taille et la dimension de la
- fenêtre d'application (sous système 2.0 uniquement) avec une ligne de la
- forme :
-
- appwin: x y l h
-
- où "x", "y", indiquent la position du coin supérieur gauche, "l" la largeur
- et "h" la hauteur de la fenêtre. Notez qu'il n'y a aucun contrôle sur les
- valeurs que vous indiquez, en cas d'erreur la fenêtre ne sera pas ouverte.
-
- APrf accepte des lignes vides dans le fichier. Une ligne commençant
- par un point-virgule (";") sera considérée comme un commentaire et ne sera
- donc pas interprétée.
- Le fichier "S:APrf.Init" sera rechargé chaque fois que vous
- sélectionnerez la commande "Options défaut" dans le menu "Outils". En mode
- eXpress (voir §3.2), le fichier "S:APrf.Init" ne sera chargé qu'en cas de
- besoin, c'est-à-dire si vous indiquez une option -C ou -I. Notez enfin que
- les séquences sont envoyées par une commande PRD_RAWWRITE, c'est-à-dire
- qu'elles ne seront pas interprétées par le pilote d'imprimante.
-
- Gestion_de_la_mémoire
-
- Avant d'imprimer ou de pré-visualiser un fichier, APrf le charge
- entièrement en mémoire. Une fois le traitement terminée, le fichier est
- conservé en mémoire, ce qui permet d'éviter de le recharger à nouveau si
- vous demandez ensuite une impression ou une pré-visualisation de ce même
- fichier.
-
- La mémoire occupée par le fichier est libérée automatiquement quand
- APrf est iconifié (voir §2.5), quand vous choisissez un nouveau fichier à
- imprimer (voir §2.4), ou quand vous choisissez la commande "Fichier suivant"
- du menu "Projet" (voir §2.5). Le fichier peut également être libéré (mais
- dans certains cas seulement) si vous choisissez la commande "Options par
- défaut" du menu "Outils".
- Vous pouvez forcer APrf à charger immédiatement le fichier à
- imprimer avec la commande "Charge fichier" du menu "Outils". Si le fichier
- était déjà présent en mémoire, il sera rechargé quand même. Vous pouvez
- également forcer APrf à libérer la mémoire occupée par le fichier avec la
- commande "Libère fichier" du menu "Outils".
- Pour vous permettre de savoir si le fichier est chargé en mémoire ou
- non, APrf affiche le caractère "*" à droite du nom du fichier quand il est
- chargé en mémoire.
-
- Ce mode de fonctionnement peut avoir deux inconvénients. Le premier
- est que le fichier occupe de la mémoire peut-être inutilement (je pense ici
- à ceux qui n'ont que 512 Ko de mémoire). Dans ce cas, vous pouvez soit
- iconifier APrf (voir §2.5, vous gagnez en plus la mémoire occupée par le
- tampon de sortie, par quelques zones de travail, et au moins 32 Ko de
- mémoire CHIP), soit utiliser la commande "Libère fichier" du menu "Outils".
- Le second est que si vous modifiez le fichier sur disquette, ces
- modifications pourraient ne pas être prises en compte, puisque APrf ne
- recharge pas le fichier. Pour éviter cela, APrf essaye de détecter si le
- fichier a été modifié depuis le dernier chargement en mémoire, et si tel est
- le cas vous propose de le recharger.
-
- Le_tampon_de_sortie
-
- APrf utilise un tampon de sortie, afin de réduire le nombre d'ordres
- d'écriture. Avec un tampon d'un kilo-octets, l'écriture vers un fichier se
- fait au moins deux fois plus rapidement qu'avec les premières versions
- d'APrf, dont le tampon ne contenait qu'une ligne. L'écriture vers
- l'imprimante n'est pas accélérée de manière visible. Dans tous les cas, le
- nombre d'ordres d'écriture est divisé au moins par 5 (cela peut aller
- jusqu'à 14 ou 15), ce qui réduit sensiblement la charge imposée au systême,
- et PERMET AINSI DE MOINS RALENTIR LES AUTRES TACHES.
- Par défaut APrf utilise un tampon d'une page (voir §2.5 l'option
- "Tampon 1Ko" du menu "Options"), afin de réduire encore plus le nombre
- d'ordres d'écriture. Quand vous changez la taille de la page, le tampon est
- automatiquement ré-alloué pour pouvoir contenir une page entière. S'il n'y a
- plus assez de mémoire pour allouer un tampon d'une page, APrf réduit
- automatiquement la taille du tampon à un kilo-octet. S'il n'est pas possible
- d'allouer ce tampon d'un kilo-octets, APrf s'arrête et affiche le message
- d'erreur "Plus de mémoire libre".
-
- Divers
-
- Ce chapitre est un bric-à-brac de quelques indications qui n'ont pas
- trouvé place dans les autres chapitres. Il contient certains détails
- importants sur le fonctionnement du programme. Je vous conseille donc de
- lire attentivement ce qui suit, au moins une fois, et de penser à le relire
- si APrf vous semble se comporter de manière bizarre.
-
- Voici comment APrf réagit si l'option "Continu" est désactivée :
- avant d'envoyer une page à l'imprimante, une boite de requête apparait, vous
- demandant d'introduire une nouvelle feuille dans l'imprimante. Quand vous
- êtes prêt, cliquez sur "OUI" : la page sera envoyée à l'imprimante. Si vous
- cliquez sur "NON" l'impression sera abandonnée.
-
- Si vous désirez interrompre une impression, cliquez dans le cadre où
- est affiché le numéro de l'exemplaire et de la page en cours d'impression.
- Une boite de requête apparait alors, pour vous demander confirmation :
- cliquez sur "OUI" pour arrêter l'impression, ou cliquez sur "NON" pour
- reprendre l'impression.
- Si vous confirmez l'arrêt de l'impression, l'envoi des données à
- l'imprimante est alors suspendu, ce qui ne veut pas forcément dire que
- l'impression s'arrête tout de suite : il faut attendre que l'imprimante ait
- vidé son tampon. Un message apparait pour vous informer que votre demande a
- été prise en compte, et APrf attend que l'ordre d'écriture en cours soit
- terminé (cela peut prendre un certain temps !).
-
- Pour vous permettre d'améliorer la présentation de vos documents,
- APrf reconnait les séquences ANSI suivantes :
-
- ESC[0m caractères normaux
- ESC[3m début d'italique
- ESC[23m fin d'italique
- ESC[4m début de souligné
- ESC[24m fin de souligné
- ESC[1m début de gras
- ESC[22m fin de gras
- ESC[1"z qualité listing
- ESC[2"z qualité courrier
-
- Ces séquences sont envoyées à l'imprimante, mais les caractères qui les
- composent ne sont pas pris en compte dans le calcul de la mise en page. De
- même, ils n'apparaissent pas lors de la pré-visualisation. Toute autre
- séquence ne sera pas reconnue, et sera considéré comme faisant partie du
- texte à imprimer. Vous pouvez filtrer ces séquences, si vous ne souhaitez
- pas qu'elles soient envoyées à l'imprimante (voir §2.5, option "Filtre ANSI"
- du menu "Options").
- La taille de ces séquences est limitée à 32 caractères par LIGNE DE
- SORTIE (et non par ligne du fichier à imprimer). Cela correspond à 6 ou 8
- séquences, et devrait être suffisant dans la plupart des cas. S'il y a trop
- de séquences sur une ligne de sortie, le message d'erreur "Lignes trop
- longues, impression abandonnée" apparaitra en cours d'impression.
-
- Sauf si le filtrage des caractères de contrôle est actif, un
- caractère "Saut de page" dans le fichier à imprimer provoquera un saut de
- page lors de l'impression. Notez enfin que les caractères "Backspace" (code
- ASCII 8) ne sont pas comptés lors de la composition des lignes.
-
-
-
- 2.1 alias Appel_depuis_le_CLI
- 2.2 alias Appel_depuis_le_Workbench
- 2.3 alias Démarrage
- 2.4 alias Les_gadgets
- 2.5 alias Les_menus
- 2.6 alias Entête_et_pied_de_page
- 2.7 alias Pré_Visualisation
- 2.8 alias Modification_de_la_sélection
- 3.1 alias La_bibliothèque_powerpacker.library
- 3.2 alias Le_mode_eXpress
- 3.3 alias Le_mode_AREXX
- 3.4 alias La_fenêtre_d'application
- 3.5 alias Le_fichier_APrf.Init
- 4.1 alias Gestion_de_la_mémoire
- 4.2 alias Le_tampon_de_sortie
- 5 alias Divers
-
-
-
-
-